---
title: "current request · RUAL Documentation"
description: "Retrieves a reference to the current HTTP Connection"
canonical: https://docs.rual.nl/block-types/http connection/httpconnection_current_request
language: en
---

# current request

This block is part of the [`http connection`](https://docs.rual.nl/block-types/http%20connection) group and was last modified in core [`v13.0.4`](https://docs.rual.nl/core-versions/130004).

Retrieves a reference to the current HTTP Connection

- connection `httpconnection`

[current request](https://docs.rual.nl/block-types/http connection/httpconnection_current_request) hands the incoming call to the blocks that answer it: the connection pin feeds [reply in JSON](https://docs.rual.nl/block-types/http connection/httpconnection_set_json) and [get query](https://docs.rual.nl/block-types/http connection/httpconnection_get_query), a [number](https://docs.rual.nl/block-types/number/number_default) sets the status code, and a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) runs the flow.

![Studio canvas example for the current request block: the current request as connection source.](https://docs.rual.nl/canvas-examples/httpconnection_current_request.png)

### Commonly used with

One of the most-used blocks across production blueprints. It is most often wired together with:

- [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json): this block feeds into it. Reply to any httpconnection as JSON body.

- [get body](https://docs.rual.nl/block-types/http%20connection/httpconnection_get_body): this block feeds into it. Returns the provided body as object, if the request method is POST or PUT.

- [get query](https://docs.rual.nl/block-types/http%20connection/httpconnection_get_query): this block feeds into it. Returns all query items if present. Query items may be given in the URI like ?query=yes.

- [get params](https://docs.rual.nl/block-types/http%20connection/httpconnection_get_params): this block feeds into it. Returns all params if present, params are optional or required parameters in API URIs, for example :name.

- [headers](https://docs.rual.nl/block-types/http%20connection/httpconnection_get_headers): this block feeds into it. Returns all headers known to us in the HTTP request.

- [reply with file](https://docs.rual.nl/block-types/files/httpconnection_set_file): this block feeds into it. reply to http connection with a file.

### Used in these guides

These documentation pages use or explain this block:

- [Common Blueprint Patterns](https://docs.rual.nl/blueprints/common-patterns)

- [Block Templates, Combinations That Work](https://docs.rual.nl/block-types/block-templates)

- [Quickstart](https://docs.rual.nl/getting-started/quickstart)

- [Block Quick Reference](https://docs.rual.nl/reference/block-quick-reference)

- [Build Your First API](https://docs.rual.nl/cluster/api-quickstart)

- [Finding Blocks](https://docs.rual.nl/block-types/finding-blocks)

### Version history

Introduced in [`v13.0.4`](https://docs.rual.nl/core-versions/130004).